home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / program / nasm095s.zip / RDOFF / README < prev    next >
Text File  |  1997-07-27  |  3KB  |  85 lines
  1. RDOFF Utils v0.2
  2. ================
  3.  
  4. The files contained in this directory are the C source code of a set
  5. of tools (and general purpose library files) for the manipulation of
  6. RDOFF version 1 object files. Here is a brief summary of their usage:
  7.  
  8. rdfdump
  9. =======
  10.  
  11. This tool prints a list of the header records in an RDOFF object in 
  12. human-readable form, and optionally prints a hex dump of the contents
  13. of the code and data segments.
  14.  
  15. Usage:
  16.     rdfdump [-v] filename
  17.  
  18. The -v flag specifies that the hex dump (see above) should be printed.
  19.  
  20. ldrdf
  21. =====
  22.  
  23. This tool is a version of unix 'ld' (or DOS 'link') for use with RDOFF
  24. files. It is capable of linking RDOFF objects, and libraries produced
  25. with the 'rdlib' utility discussed below.
  26.  
  27. In normal usage, its command line takes the form:
  28.  
  29.     ldrdf [-o output-file] object files [-llibrary ...]
  30.  
  31. Libraries must be specified with their path as no search is performed.
  32. Modules in libraries are not linked to the program unless they are
  33. referred to.
  34.  
  35. Most of its options are not implemented, but those that are are listed here:
  36.  
  37.    -v    increase verbosity level. Currently 4 verbosity levels are 
  38.     available: default (which only prints error information), normal
  39.     (which prints information about the produced object, -v), medium
  40.     (which prints information about what the program is doing, -v -v)
  41.     and high (which prints all available information, -v -v -v).
  42.  
  43.    -p    change alignment value to which multiple segments combigned into
  44.     a single segment should be aligned (must be either 1, 2, 4, 8,
  45.     16, 32 or 256. Default is 16).
  46.  
  47. The default output filename is 'aout.rdx'.
  48.  
  49. rdx
  50. ===
  51.  
  52. This program simply loads and executes an RDOFF object, by calling
  53. '_main', which it expects to be a C-style function, which will accept
  54. two parameters, argc and argv in normal C style.
  55.  
  56. rdflib
  57. ======
  58.  
  59. This program creates a library file for use with ldrdf.
  60.  
  61. It is supplied with a shell script 'makelib' which should probably be used
  62. to create libraries.
  63.  
  64. Usage:
  65.     rdflib command library [optional arguments]
  66.  
  67. Valid commands are:
  68.  
  69.     c    Create the library
  70.     a    Add a module (requires a filename and a name to give the
  71.         module, ie 'rdflib a libc.rdl strcpy.rdf strcpy' puts the
  72.         file 'strcpy.rdf' into 'libc.rdl', and calls it 'strcpy'.
  73.     x    Extract (arguments are the opposite to the 'a' command,
  74.         ie you'd do 'rdflib x libc.rdl strcpy strcpy.rdf to get
  75.         a copy of strcpy.rdf back out again...)
  76.  
  77. Remove and List commands will be added soon (they're already documented
  78. as existing, but I haven't had time to implement them... if anyone
  79. else wants to do this, they're welcome to. The file format should be
  80. amply documented in the source code... look at 'rdflib.c' and 'rdlib.c',
  81. and the relevant sections of 'ldrdf.c' to see how libraries can be
  82. handled).
  83.  
  84. Julian Hall <jules@earthcorp.com>
  85.